Skip to content

SUPP-144: Disambiguate Try It endpoint names for profile APIs - #15

Merged
caracheng merged 9 commits into
mainfrom
copilot/supp-144-add-specific-names-api-endpoints
Jul 22, 2026
Merged

SUPP-144: Disambiguate Try It endpoint names for profile APIs#15
caracheng merged 9 commits into
mainfrom
copilot/supp-144-add-specific-names-api-endpoints

Conversation

Copilot AI commented Jun 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

The Try It endpoint switcher showed ambiguous duplicate names (for example, multiple “Update Property” entries) without sidebar context. This change makes profile-related endpoint labels explicit so users can distinguish user-profile vs group-profile operations at a glance.

  • What changed

    • Updated reference page frontmatter titles for overlapping profile operations to include scope (User Profile or Group Profile).
    • Applied to the duplicated operation families: set/update, set once, delete/unset, remove-from-list, and union.

  • Where

    • reference/profile-*.mdx
    • reference/group-*.mdx
    • reference/user-profile-union.mdx

  • Example

    ---
openapi: /openapi/ingestion.openapi.yaml POST /groups#group-set
title: Update Group Profile Property
---
Original prompt
<title>Suggestion: Add more specific name to API endpoints</title> **Type:** Suggestion · **Fix before launch:** Yes · **Reporter:** Myron Fung

Suggestion summary
When you open the Try It module in the API, clicking on the top-left dropdown shows all of the other API endpoints you can switch to. However, there are many duplicate names since the dropdown does not have context of the subsection. For example, there are 2 options for "Update Property" — one is for group profile while the other is for user profile, but that is not obvious from the Try It module dropdown without the sidebar organizational context.

Migrated from Notion · source entry


Fix before launch

Only assign incident/ labels when asked to by a user. incident/ labels are reserved for customer facing incidents.
Fixes https://linear.app/mixpanel/issue/SUPP-144/suggestion-add-more-specific-name-to-api-endpoints

Branch naming

This task relates to issue SUPP-144 — preserve that identifier somewhere in the branch name and pull request title for traceability. Do not treat the identifier as a verbatim slug or prepend it with a hyphen by default; instead, adapt the full branch name to comply with the repository's branch-naming pattern, adding any required prefix or restructuring the shape as needed.

Include a link to the original issue in the pull request description: https://linear.app/mixpanel/issue/SUPP-144/suggestion-add-more-specific-name-to-api-endpoints

@linear-code

linear-code Bot commented Jun 9, 2026 •
edited
Loading

Copy link
Copy Markdown
SUPP-144 Suggestion: Add more specific name to API endpoints

Type: Suggestion · Fix before launch: Yes · Reporter: Myron Fung

Suggestion summary
When you open the Try It module in the API, clicking on the top-left dropdown shows all of the other API endpoints you can switch to. However, there are many duplicate names since the dropdown does not have context of the subsection. For example, there are 2 options for "Update Property" — one is for group profile while the other is for user profile, but that is not obvious from the Try It module dropdown without the sidebar organizational context.

Migrated from Notion · source entry

Review in Linear · Agent session

Copilot AI changed the title [WIP] Add more specific names to API endpoints SUPP-144: Disambiguate Try It endpoint names for profile APIs Jun 9, 2026
Copilot AI requested a review from myronkaifung June 9, 2026 21:42
@greptile-apps

greptile-apps Bot commented Jun 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Confidence Score: 5/5

This looks safe to merge.

  • The user and group union titles now match their endpoint scopes.
  • No blocking issues remain in the updated code.

Important Files Changed
Filename Overview
reference/group-union.mdx Labels the group union endpoint as a Group Profile operation.
reference/user-profile-union.mdx Labels the user union endpoint as a User Profile operation.

Reviews (4): Last reviewed commit: "Merge branch 'main' into copilot/supp-14..." | Re-trigger Greptile

greptile-apps[bot]
greptile-apps Bot reviewed Jun 9, 2026
View reviewed changes
Comment thread reference/group-union.mdx Outdated
Comment thread reference/user-profile-union.mdx Outdated
@myronkaifung
myronkaifung marked this pull request as ready for review July 22, 2026 02:03
@myronkaifung
myronkaifung requested a review from a team as a code owner July 22, 2026 02:03
@caracheng
caracheng enabled auto-merge (squash) July 22, 2026 20:37
@caracheng
caracheng merged commit 22c0520 into main Jul 22, 2026
6 checks passed
@caracheng
caracheng deleted the copilot/supp-144-add-specific-names-api-endpoints branch July 22, 2026 20:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@greptile-apps greptile-apps[bot] greptile-apps[bot] left review comments
@caracheng caracheng caracheng approved these changes
+1 more reviewer
@myronkaifung myronkaifung myronkaifung approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

@myronkaifung myronkaifung

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@caracheng @myronkaifung